home *** CD-ROM | disk | FTP | other *** search
/ HamCall (October 1991) / HamCall (Whitehall Publishing)(1991).bin / util / ezfile / easyfile.doc < prev    next >
Text File  |  1990-10-14  |  67KB  |  1,338 lines
  1.  
  2.  
  3.  
  4.  
  5.                                         No Sweat!
  6.  
  7.                                     ┌─────────────┐
  8.                                     │  Programs   │
  9.                                     │      _      │
  10.                                     │     (_)°    │
  11.                                  ┌──┴──────────┐  │
  12.                                  │  Archives   │  │
  13.                                  │      _      │  │
  14.                                  │     (_)°    ├──┘
  15.                               ┌──┴──────────┐  │
  16.                               │     DOS     │  │
  17.                               │      _      │  │
  18.                               │     (_)°    ├──┘
  19.                               │             │
  20.                               │      ▓      │
  21.                               │      ▓      │
  22.                               └───▀─────▀───┘
  23.  
  24.                               EASYFILE  1.5
  25.                             by Dennis LaBelle
  26.  
  27.  
  28.  
  29.  
  30.                                    May 9, 1989
  31.  
  32.                        Copyright (c) 1988 by D.R. LaBelle
  33.  
  34.  
  35.  
  36.  
  37.  
  38.   This  program  is  provided free for personal,  private use.  Commercial and
  39.   corporate use beyond a trial period of 30 days requires registration and the
  40.   purchase of a license.
  41.  
  42.   In any case, the program may be copied and shared with others.
  43.  
  44.   The  author  makes no warranties,  either express or implied,  regarding the
  45.   program's merchantability,  or its fitness for any particular  purpose.  The
  46.   author  will  not  be liable for any damages,  including lost profits,  lost
  47.   savings or other incidental or consequential damages arising out of the  use
  48.   of  or  inability  to  use  EASYFILE,  even  if  he  has been advised of the
  49.   possibility of such damages,  or for any  claim  by  any  other  party.  All
  50.   commercial rights are reserved by the author.
  51.  
  52.  
  53.   EASYFILE User's Manual                                                Page 2
  54.  
  55.  
  56.  
  57.                        *** EASYFILE TABLE OF CONTENTS ***
  58.  
  59.   Title page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Page  1
  60.   Table of Contents. . . . . . . . . . . . . . . . . . . . . . . . . . Page  2
  61.   Included files . . . . . . . . . . . . . . . . . . . . . . . . . . . Page  3
  62.   Quick start  . . . . . . . . . . . . . . . . . . . . . . . . . . . . Page  3
  63.   Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . Page  4
  64.   System requirements  . . . . . . . . . . . . . . . . . . . . . . . . Page  4
  65.   Setting up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Page  5
  66.   Setup options - quick summary  . . . . . . . . . . . . . . . . . . . Page  5
  67.   Setup options - detailed description . . . . . . . . . . . . . . . . Page  6
  68.   Screen organization of EASYFILE  . . . . . . . . . . . . . . . . . . Page 11
  69.   Screen sample illustration . . . . . . . . . . . . . . . . . . . . . Page 11
  70.   Keyboard operation of EASYFILE . . . . . . . . . . . . . . . . . . . Page 12
  71.   Normal key assignments . . . . . . . . . . . . . . . . . . . . . . . Page 12
  72.   Function Key assignments . . . . . . . . . . . . . . . . . . . . . . Page 13
  73.   Control/Alternate key combinations . . . . . . . . . . . . . . . . . Page 13
  74.   Using EASYFILE with a mouse  . . . . . . . . . . . . . . . . . . . . Page 14
  75.   Illustration of screen regions . . . . . . . . . . . . . . . . . . . Page 15
  76.   Top line menu commands . . . . . . . . . . . . . . . . . . . . . . . Page 17
  77.   Application menus  . . . . . . . . . . . . . . . . . . . . . . . . . Page 19
  78.   EZINST - The EASYFILE configuration utility  . . . . . . . . . . . . Page 25
  79.   EZMENU - The EASYFILE application menu generator . . . . . . . . . . Page 25
  80.   Miscellaneous  . . . . . . . . . . . . . . . . . . . . . . . . . . . Page 25
  81.  
  82.  
  83.  
  84.   EASYFILE User's Manual                                                Page 3
  85.  
  86.  
  87.                              *** INCLUDED FILES ***
  88.  
  89.   The following program and documentation files  should  be  included  in this
  90.   distribution copy of EASYFILE.
  91.  
  92.                   APPSMENU.TXT -  Sample application menu file
  93.                   COMLIST.TXT  -  Sample command list file
  94.                   EASYFILE.EXE -  Executable program.
  95.                   EASYFILE.DOC -  The documentation for EASYFILE.
  96.                   EASYMIN.EXE  -  Helps minimize EASYFILE's memory usage
  97.                   EZINST.EXE   -  EASYFILE configuration utility.
  98.                   EZMENU.EXE   -  EASYFILE application menu generator
  99.                   GAMEMENU.TXT -  Sample application menu file
  100.                   INSTALL.BAT  -  Hard disk installation file
  101.                   README       -  Additional information on EASYFILE.
  102.                   ZIPCOM.TXT   -  Sample ZIP comment file
  103.  
  104.                                *** QUICK START ***
  105.  
  106.   If it is necessary to use EASYFILE immediately,  read this section first  to
  107.   become   acquainted   with   the   basic  options.   The  remainder  of  the
  108.   documentation should be read in order to make best use of the program.
  109.  
  110.   EASYFILE may be invoked by typing EASYFILE and pressing [Enter] at  the  DOS
  111.   prompt.  Common  EASYFILE actions are displayed in a menu on the top line of
  112.   the screen.  You may select one of the menu options by pressing the tab  key
  113.   or  spacebar  until  the  desired  option  is  highlighted and then pressing
  114.   [Enter] -- or more quickly,  by simply pressing the first character of  each
  115.   option.  If you have a mouse, Top line menu items may be performed by moving
  116.   the mouse cursor to the desired option and pressing the left  mouse  button.
  117.   Selecting  "Other"  will  provide  pull  down  menus  for all other EASYFILE
  118.   functions,  Alt key and Ctrl key assignments not  on  this  top  line  menu.
  119.   EASYFILE has been designed for easy use with either the keyboard or a mouse.
  120.  
  121.   New ZIP or ARC files are created by copying one or more files to a file name
  122.   having a ZIP or ARC extension.
  123.  
  124.   Both EASYFILE.EXE and EASYMIN.EXE must be accessible through the DOS path in
  125.   order for the "minimize" feature to work.
  126.  
  127.   Run EZINST.EXE to customize EASYFILE to your system.
  128.  
  129.  
  130.  
  131.   EASYFILE User's Manual                                                Page 4
  132.  
  133.  
  134.                               *** INTRODUCTION ***
  135.  
  136.   EASYFILE is designed to make management of your hard disk files,  especially
  137.   archived files, much easier. Two different, sorted directories are displayed
  138.   side by side,  allowing you to select both individual files  and  groups  of
  139.   files for EASYFILE to act on. You can easily:
  140.  
  141.       - treat an archived file as a simple subdirectory of files
  142.            ZIP and ARC style archives are currently supported
  143.       - convert one style archive file to another
  144.       - automatically add comments to a ZIP file
  145.       - copy and delete files.
  146.       - rename files and directories.
  147.       - pass files to an external browse utility or favorite text editor.
  148.       - move files from one directory to another.
  149.       - add and delete subdirectories.
  150.       - run other programs from within the EASYFILE environment.
  151.       - display files in sorted order.
  152.       - set a directory mask so that only certain files are displayed.
  153.       - backup files.
  154.       - print a hard copy of a sorted directory.
  155.       - create user defined menus to run applications
  156.       - selectively disable features of EASYFILE depending on user need
  157.  
  158.   EASYFILE  has the ability to display a visual,  sorted directory tree so you
  159.   can quickly display a particular subdirectory on either side of the EASYFILE
  160.   screen.  In addition,  EASYFILE contains many advanced file management tools
  161.   including the ability to set or clear file attributes.
  162.  
  163.   For users who upload and download files from bulletin boards, EASYFILE links
  164.   to archive utilities such as Phil Katz's PKPAK,  PKUNPAK and PKZIP,  PKUNZIP
  165.   to easily copy, create, extract, execute,  delete,  update and view archived
  166.   files.
  167.  
  168.  
  169.                            *** SYSTEM REQUIREMENTS ***
  170.  
  171.   EASYFILE makes full use of the PC keyboard,  using the  function  keys,  the
  172.   cursor  keys,  tab  key,  space bar,  and several Ctrl/Alt key combinations.
  173.   EASYFILE fully supports the use of a mouse and is most efficiently  operated
  174.   with  one.  In  order  to  make full use of all of EASYFILE's features,  the
  175.   following conditions should be met:
  176.  
  177.        The program is designed to operate satisfactorily with DOS 2.x and
  178.        above.  However, DOS 3.x is prefered. In a few cases, the features
  179.        offered   by   EASYFILE   depend   on  the  presence  of  DOS  3.x
  180.        enhancements.
  181.  
  182.        EASYFILE requires a minimum of 130K memory and one diskette  drive
  183.        for   operation   on   an  IBM-PC/XT/AT  or  compatible  computer.
  184.        Additional memory is required to use shell options.
  185.  
  186.  
  187.  
  188.   EASYFILE User's Manual                                                Page 5
  189.  
  190.  
  191.                                *** SETTING UP ***
  192.  
  193.   Both EASYFILE.EXE and EASYMIN.EXE must be accessible through the DOS path if
  194.   the "minimize" feature is to be used.
  195.  
  196.   EASYFILE is invoked by entering the following line at the DOS prompt.
  197.  
  198.                         EASYFILE [command list file name]
  199.  
  200.   The  square  brackets  denote an optional argument,  and are not typed.
  201.  
  202.   It  is  possible  to  adjust  the  behavior  of several EASYFILE features at
  203.   startup.  The actions to perform when files with particular  extensions  are
  204.   selected  can  also  be defined.  This is done in the COMMAND LIST file.  If
  205.   the COMMAND LIST file name is not specified on the command line, the program
  206.   will look for the default file name of COMLIST.TXT.  The program  EZINST.EXE
  207.   is provided to help you generate the COMMAND LIST file.
  208.  
  209.   Each line of this special file should start with an option name followed  by
  210.   the new option value as in the example below.
  211.  
  212.                                TEMPDIR=c:\scratch
  213.  
  214.   This  line  changes the directory that EASYFILE uses to writes its temporary
  215.   files.  There should be no spaces before or after the equals sign. A listing
  216.   of the options, their default values, possible values and purpose follows.
  217.  
  218.                                   Quick Summary
  219.  
  220.      Option        Default value      Possible values
  221.      ------        -------------      -------------------------------------
  222.      arcext        ARC                any file extension
  223.      apps                             any file path
  224.      colorsXX                         0 to 255
  225.      editcmd       ED                 any file path
  226.      extcmd                           any command line string
  227.      leftdir       current directory  any directory
  228.      listcmd                          any file path
  229.      minimize      OFF                OFF, ON
  230.      off           0                  0 to 16,777,216
  231.      packcmd       PACK               any file path
  232.      rightdir                         any directory
  233.      sortorder     NOSORT             NOSORT, BYNAME, BYDATE, BYSIZE, BYEXT
  234.      tempdir       c:\                any directory
  235.      unpackcmd     UNPACK             any file path
  236.      video         CGA                MDA, CGA, EGA
  237.      zipcoment                        any file path
  238.  
  239.   The program files defined in the listcmd, packcmd and unpackcmd options must
  240.   be available through the DOS path.
  241.  
  242.  
  243.  
  244.   EASYFILE User's Manual                                                Page 6
  245.  
  246.  
  247.                         Detailed Description of Options
  248.  
  249.   OPTION         : apps
  250.   DEFAULT VALUE  : none
  251.   PURPOSE        : defines the file name of the start-up application menu
  252.   DISCUSSION     : This option identifies the file  name  of  the  application
  253.                    menu which should be read when first starting EASYFILE. See
  254.                    the section  entitled  APPLICATION  MENUS  for  a  detailed
  255.                    description of these files.
  256.  
  257.   OPTION         : arcext
  258.   DEFAULT VALUE  : arc
  259.   PURPOSE        : file name extension for archived files using the ARC format
  260.   DISCUSSION     : This option specifies the  file  name  extension  used  for
  261.                    archived files using the ARC format.  If the file is  found
  262.                    to be an archive,  it will be treated in the same manner as
  263.                    a subdirectory.  For example:  the individual files of  the
  264.                    archive  C:\DATA\JAN.ARC  could  be listed in a window with
  265.                    C:\DATA\JAN.ARC listed as the current directory  name.  The
  266.                    files  in  the  archive can be acted on (e.g.  move,  list,
  267.                    edit, copy, etc.) in the same manner as non-archived files.
  268.                    EASYFILE  will  use  the  archive  packing  and   unpacking
  269.                    programs, as necessary, to perform its functions.  You will
  270.                    not  have to concern yourself with the packing or unpacking
  271.                    steps, since they are handled by EASYFILE itself.
  272.  
  273.                    Phil Katz's ZIP archive file format is supported by EASYFILE
  274.                    without needing to  specify  the  ZIP  file  extension.  The
  275.                    PKZIP.EXE  and  PKUNZIP.EXE files must be accessible through
  276.                    the DOS path.
  277.  
  278.   OPTION         : editcmd
  279.   DEFAULT VALUE  : ed
  280.   PURPOSE        : specify name of program used to EDIT files
  281.   DISCUSSION     : This option is used to define the name of the program which
  282.                    will  be  called  when  EASYFILE's EDIT feature is invoked.
  283.                    This should be the name of your favorite word processor.
  284.  
  285.   OPTION         : extcmd
  286.   DEFAULT VALUE  : none
  287.   PURPOSE        : define actions to perform when files are executed
  288.   DISCUSSION     : This option informs EASYFILE of the command which should be
  289.                    issued  to  DOS when a file with the specified extension is
  290.                    executed.  A caret (^),  followed by the extension name  is
  291.                    used  as  a  place  holder for the file name on the command
  292.                    line.  Three  sample  entries  for  this  option  are shown
  293.                    below.
  294.                                 EXTCMD=list ^.doc
  295.                                 EXTCMD=list ^.txt
  296.                                 EXTCMD=qc ^.c /h
  297.  
  298.                    With  these  COMMAND  LIST  lines,   all  file  names  with
  299.                    extensions  of  either  DOC  or  TXT would be passed to the
  300.                    program  LIST.  And  if  the  file  HELLO.C  was  executed,
  301.                    EASYFILE would pass the command line QC HELLO.C /H to DOS.
  302.  
  303.  
  304.   EASYFILE User's Manual                                                Page 7
  305.  
  306.  
  307.                   Detailed Description of Options (Continued)
  308.  
  309.   OPTION         : colors0 through colors14
  310.   DEFAULT VALUE  : see following table
  311.   PURPOSE        : Used to specify the EASYFILE colors
  312.   DISCUSSION     : This option is used to define the color  attribute  for  15
  313.                    different sections of the EASYFILE screen.The default color
  314.                    scheme for EASYFILE consists of the following:
  315.  
  316.                    Option    Item Affected           Default Value/Color
  317.                    ------    -------------           -------------------
  318.  
  319.                    colors0   Menu line               70H; black on white
  320.                    colors1   Menu select             1FH; bright white on blue
  321.                    colors2   Action key              71H; blue on white
  322.                    colors3   Normal message          07H; white on black
  323.                    colors4   Highlighted text        0EH; yellow on black
  324.                    colors5   Normal file             17H; white on blue
  325.                    colors6   Selected file           0EH; yellow on black
  326.                    colors7   Marked file             1FH; bright white on blue
  327.                    colors8   Selected & marked file  4EH; yellow on red
  328.                    colors9   Window borders          70H; black on white
  329.                    colors10  Apps/Pick/List text     0EH; yellow on black
  330.                    colors11  Apps/Pick select        1FH; bright white on blue
  331.                    colors12  Selection boxes         4FH; bright white on red
  332.                    colors13  Mouse cursor            2EH; yellow on green
  333.                    colors14  Scroll bar              0FH; bright white
  334.  
  335.  
  336.                    There are a few  background/foreground  color  combinations
  337.                    that  have  a  special  effect with respect to highlighting
  338.                    files. If the background and foreground colors for a marked
  339.                    file are made identical, a pointer () will appear  to  the
  340.                    left of the file  when  marked.  If both the background and
  341.                    foreground colors for a selected file are made identical, a
  342.                    flashing pointer () will appear to the left of  the  file.
  343.                    The latter is also true for a file which is both marked and
  344.                    selected.
  345.  
  346.   OPTION         : leftdir
  347.   DEFAULT VALUE  : current directory when invoking EASYFILE
  348.   PURPOSE        : define directory displayed in left window at start up
  349.   DISCUSSION     : This command list option is used  to  specify  the  initial
  350.  
  351.                    directory  to  be  viewed  in the left window when invoking
  352.                    EASYFILE.  If  not  specified,  the  default drive and path
  353.                    directory will display in the left window.
  354.  
  355.   OPTION         : listcmd
  356.   DEFAULT VALUE  : list
  357.   PURPOSE        : specify name of an external program used to LIST files
  358.   DISCUSSION     : This command list option is used to define the name of  the
  359.                    program  which  will  be  called in place of EASYFILE's own
  360.                    LIST routine.  This may be the name of your  favorite  file
  361.                    viewing  program.  EASYFILE  has  an internal LIST function
  362.                    which is normally used if this option is not specified.
  363.  
  364.   EASYFILE User's Manual                                                Page 8
  365.  
  366.  
  367.                   Detailed Description of Options (Continued)
  368.  
  369.   OPTION         : off
  370.   DEFAULT VALUE  : 0
  371.   PURPOSE        : designate the EASYFILE features to deactivate
  372.   DISCUSSION     : Several EASYFILE  features  may  be  deactivated when first
  373.                    invoking the program.  This option may be used to limit the
  374.                    capabilities of the program when used by a novice or person
  375.                    needing restricted  access  to  your  files.  Each  feature
  376.                    which  may  be deactivated has a number associated with it.
  377.                    This value will be a power of 2, such as 4 (2 squared).  By
  378.                    summing  the  associate values for each feature you wish to
  379.                    turn off you will arrive at the number to specify for  this
  380.                    option.
  381.  
  382.                    Power
  383.                    of 2    Feature to Deactivate
  384.                    -----   ---------------------------------------------------
  385.                      0     Copy
  386.                      1     Move
  387.                      2     Delete
  388.                      3     XEQ
  389.                      4     Pick
  390.                      5     List
  391.                      6     Edit
  392.                      7     Make new subdirectory
  393.                      8     Remove subdirectory
  394.                      9     Show subdirectory on left
  395.                     10     Show subdirectory on right
  396.                     11     Enter new path for left
  397.                     12     Enter new path for right
  398.                     13     Set archive bit on files
  399.                     14     Clear archive bit on files
  400.                     15     Hide files
  401.                     16     Unhide files
  402.                     17     Protect files
  403.                     18     Un-Protect files
  404.                     19     Convert archives
  405.                     20     Backup files
  406.                     21     Shell to DOS
  407.                     22     Rename file or subdirectory
  408.                     23     Quit: Current dir. active
  409.  
  410.                     Example: To prevent deleting or editing a file,  the value
  411.                              for this option should be set to
  412.  
  413.                              2^2 + 2^6 = 4 + 64 = 68
  414.  
  415.                              The OFF option value would be set to OFF=68
  416.  
  417.  
  418.  
  419.   EASYFILE User's Manual                                                Page 9
  420.  
  421.  
  422.                   Detailed Description of Options (Continued)
  423.  
  424.   OPTION         : minimize
  425.   DEFAULT VALUE  : OFF
  426.   PURPOSE        : When set to ON, minimizes EASYFILE's use of RAM
  427.   DISCUSSION     : When set to ON, this option causes EASYFILE to use only 23K
  428.                    of memory when running applications from  the  user  menus.
  429.                    EASYFILE will use its smaller companion program EASYMIN.EXE
  430.                    to run your application.  After  your  application  program
  431.                    terminates, EASYMIN.EXE will reload EASYFILE.
  432.  
  433.                    IMPORTANT: Both programs EASYFILE.EXE and EASYMIN.EXE  must
  434.                               be in the DOS path for this feature to work.
  435.  
  436.   OPTION         : packcmd
  437.   DEFAULT VALUE  : pack
  438.   PURPOSE        : specify name of program used to pack & create archives
  439.   DISCUSSION     : This option is used to specify for EASYFILE the name of the
  440.                    program you normally use to pack and create archives in the
  441.                    ARC format.  The specified packing program should have  the
  442.                    same   command  line  syntax  as  Phil  Katz's  PKPACK.EXE.
  443.                    EASYFILE will issue the necessary calls to this program  to
  444.                    perform any packing required.
  445.  
  446.   OPTION         : rightdir
  447.   DEFAULT VALUE  : none
  448.   PURPOSE        : define directory displayed in right window at start up
  449.   DISCUSSION     : This command list option specifies the initial directory to
  450.                    be viewed in the right window when  invoking  EASYFILE.  If
  451.                    not specified, the right window will initially be empty.
  452.  
  453.   OPTION         : sortorder
  454.   DEFAULT VALUE  : NOSORT
  455.   PURPOSE        : define the sort order of the files at start up
  456.   DISCUSSION     : Following are the possible values and their sort orders.
  457.  
  458.                    Value      Sort order
  459.                    -----      --------------------------------------
  460.                    NOSORT     as found in directory
  461.                    BYNAME     by name, ascending alphabetically
  462.                    BYDATE     by date and time, most recent first
  463.                    BYSIZE     by size, smallest files first
  464.                    BYEXT      by extension, ascending alphabetically
  465.  
  466.   OPTION         : tempdir
  467.   DEFAULT VALUE  : c:\
  468.   PURPOSE        : define directory for placing EASYFILE's temporary files
  469.   DISCUSSION     : EASYFILE may create temporary files during  the  course  of
  470.                    its  operation.  These  files  are  erased by EASYFILE once
  471.                    they are  no  longer  needed. The specified directory  must
  472.                    be empty in order for EASYFILE to work properly.
  473.  
  474.  
  475.  
  476.   EASYFILE User's Manual                                                Page 10
  477.  
  478.  
  479.                   Detailed Description of Options (Continued)
  480.  
  481.   OPTION         : unpackcmd
  482.   DEFAULT VALUE  : unpack
  483.   PURPOSE        : specify name of program used to unpack archived files
  484.   DISCUSSION     : This option is used to specify for EASYFILE the program you
  485.                    normally  use  to unpack archives with the ARC format.  The
  486.                    unpacking program should have the same command line  syntax
  487.                    as  Phil Katz's PKUNPACK.EXE.  EASYFILE will issue calls to
  488.                    this program to perform any unpacking required.
  489.  
  490.   OPTION         : video
  491.   DEFAULT VALUE  : CGA
  492.   PURPOSE        : defines the video mode used by EASYFILE
  493.   DISCUSSION     : Setting VIDEO=EGA will force EASYFILE to display  43  lines
  494.                    on an EGA card and 50 lines on a  VGA.  If  the  screen  is
  495.                    already in 43 or 50 line mode,  EASYFILE will  continue  to
  496.                    display  that  number  of  lines regardless of whether this
  497.                    option is set to EGA.  Values other than EGA have no effect
  498.                    on the number of lines displayed.
  499.  
  500.   OPTION         : zipcoment
  501.   DEFAULT VALUE  : none
  502.   PURPOSE        : specify name of file containing comment for new ZIP files
  503.   DISCUSSION     : ZIP  comments,  for the new ZIP archives created when using
  504.                    EASYFILE, may be added automatically. The contents  of  the
  505.                    specified file will be added to a ZIP archive as a comment.
  506.  
  507.  
  508.   EZINST.EXE is provided to help you generate the necessary COMMAND LIST  file
  509.   for the preceding options you wish to use.
  510.  
  511.  
  512.  
  513.   EASYFILE User's Manual                                                Page 11
  514.  
  515.  
  516.                      *** SCREEN ORGANIZATION OF EASYFILE ***
  517.  
  518.   The  following is a facsimile of EASYFILE as it appears on a monitor screen.
  519.   Some of the on-screen refinements are, of course, not possible to display on
  520.   a printer,  so it will look a bit different in actual use,  and may  contain
  521.   more lines.  Use this illustration for reference in the User's Manual.
  522.  
  523. -------------------------------------------------------------------------------
  524.  UnTagAll  Copy  Move  Delete  TagAll  Other  Apps  XEQ  Pick  List  Edit  Quit
  525. -------------------------------------------------------------------------------
  526.                              Clear all tagged files.
  527. | *.*          DISK1_VOL2        name  ||*.*          DISK1_VOL2        name  |
  528. |--------------------------------------||-------------------------------------|
  529. |                 D:\                  ||              D:\GAMES               |
  530. |--------------------------------------||-------------------------------------|
  531. | DPE            <DIR>                 ||<PARENT>       <DIR>                 |
  532. | GAMES          <DIR>                 ||ADVENT   EXE   45824 110385 11:10a   |
  533. | GRAPHICS       <DIR>                 ||ADVENT1  TXT   18304 110385 11:10a   |
  534. | INCLUDE        <DIR>                 ||ADVENT2  TXT    6528 110385 11:11a   |
  535. | INCOMING       <DIR>                 ||ADVENT3  TXT    5632 110385 11:11a   |
  536. | LASER          <DIR>                 ||ADVENT4  TXT   18304 110385 11:11a   |
  537. | LIB            <DIR>                 ||BALOON   BIN     384 061086 02:14a   |
  538. | MOUSE          <DIR>                 ||BIRD1    BIN     128 061086 02:14a   |
  539. | OLDWIND        <DIR>                 ||BIRD2    BIN     128 061086 02:14a   |
  540. | PASCAL         <DIR>                 ||BOMB     BIN     128 061086 02:14a   |
  541. | SCAN           <DIR>                 ||BOTTOM   BIN    1920 061086 02:14a   |
  542. | SCREEN         <DIR>                 ||DOC      TXT    2037 092286 21:48a   |
  543. | SHEET          <DIR>                 ||EXPLODE  BIN     128 061086 02:14a   |
  544. | SYSLIB         <DIR>                 ||INSTRUCT BIN   16128 061086 02:14a   |
  545. | TEMP           <DIR>                 ||MOUNTAIN BIN    8931 061086 02:14a   |
  546. | TEXT           <DIR>                 ||LOGO     BIN     640 061086 02:14a   |
  547. | UTILS          <DIR>                 ||LTANK    BIN     128 061086 02:14a   |
  548. | WINDOWS        <DIR>                 ||MAHJONGG DOC    5769 091187 08:31a   |
  549. | WP             <DIR>                 ||MAHJONGG EXE   89288 090987 13:52a   |
  550. | XFER           <DIR>                 ||NEWYORK  BAS   57842 081488 19:04a   |
  551. |--------------------------------------||-------------------------------------|
  552. | dir:    0K  tag:    0K  left:11428K  ||dir:  367K  tag:    0K  left:11428K  |
  553. |--------------------------------------||-------------------------------------|
  554.               Figure 1 - Facsimile of EASYFILE on a monitor screen.
  555.  
  556.   The  EASYFILE  screen,  as seen in Figure 1,  is divided into three sections
  557.   with dual side by side file windows for the display of file information  and
  558.   a two line top section for messages and menu.
  559.  
  560.   The  first  line  on  the the screen is the Top Line Menu,  with the current
  561.   selection highlighted and  the  rest  in  reverse  video.  The  top  section
  562.   contains, as its second row, the message line.  Here EASYFILE tells the user
  563.   what is happening, asks for input, or describes the current menu selection.
  564.  
  565.  
  566.  
  567.   EASYFILE User's Manual                                                Page 12
  568.  
  569.  
  570.                      *** SCREEN ORGANIZATION OF EASYFILE ***
  571.                                    (Continued)
  572.  
  573.   In each of the file windows the top line (row) shows  the  active  directory
  574.   mask,  volume label for the respective displayed disk and active sort option
  575.   for that side.  The second window row will display the full DOS path for the
  576.   directory displayed in the window.  The large central  window  area  is  the
  577.   main file display area, in which a full DOS directory (DIR) format is shown.
  578.   The right edge of the file windows contain a scroll bar that allows movement
  579.   through the file list using a mouse.
  580.  
  581.   The  directory  additionally displays hidden files and,  when applicable,  a
  582.   letter representing the file's attributes:
  583.  
  584.                        A - Archive             H - Hidden
  585.                        R - Read only           S - System
  586.  
  587.   Only one of the two windows may be considered "current" for menu or function
  588.   key  actions.  Currency  is  shown  by a bar highlighting the "current file"
  589.   within the "current window".  Below the main display,  an inverse video row,
  590.   shows  the directory size,  total bytes tagged,  and remaining bytes of disk
  591.   space.
  592.  
  593.                      *** KEYBOARD OPERATION OF EASYFILE ***
  594.  
  595.  
  596.                              NORMAL KEY ASSIGNMENTS
  597.  
  598.   The key pad controls the combination file selector and window selector.  The
  599.   keys used on the cursor pad, and their functions are:
  600.  
  601.                   1. Right Arrow - Select right window.
  602.                   2. Left Arrow  - Select left window.
  603.                   3. Up Arrow    - Scroll selection bar up
  604.                   4. Down Arrow  - Scroll selection bar down
  605.                   5. Home        - Selector to top of listing.
  606.                   6. End         - Selector to end of listing.
  607.                   7. Page Up     - Scroll window up one page.
  608.                   8. Page Dn     - Scroll window down one page.
  609.  
  610.   I - Inverts the current sort order of the file listing.
  611.   G - Prompts you to type the first letter of the file you would like the
  612.       select selection bar to go to. This provides another quick method of
  613.       movement within the directory listing.
  614.   H - Displays a summary screen of the EASYFILE commands.
  615.  
  616.  
  617.  
  618.   EASYFILE User's Manual                                                Page 13
  619.  
  620.  
  621.                             FUNCTION KEY ASSIGNMENTS
  622.  
  623.   The function keys control all the display options.  These include sort order
  624.   and drive or subdirectory viewed.  The function keys also allow modification
  625.   of file attribute bytes and creation/deletion of subdirectories.  To  use  a
  626.   function key,  select a file to use (using the arrow keys), or tag the files
  627.   to  be used (see F9,  F10 or the TagAll command described later),  and press
  628.   the function key.  The function keys are used as follows:
  629.  
  630.             F1  - Create  a new subdirectory (DOS MKDIR/MD).
  631.             F2  - Remove selected subdirectory. (DOS RMDIR/RD)
  632.             F3  - Display selected subdirectory in left window.
  633.             F4  - Display selected subdirectory in right window.
  634.             F5  - Prompt for a new path in left window.
  635.             F6  - Prompt for a new path in right window.
  636.             F7  - Sort the current window by name.
  637.             F8  - Sort the current window by extension.
  638.             F9  - Tag or untag current file for group action.
  639.             F10 - Same as F9, but advance to next file.
  640.       Shift F1  - Set archive bit on current or tagged file(s).
  641.       Shift F2  - Clear archive bit on file(s)
  642.       Shift F3  - Hide current file, tagged files.
  643.       Shift F4  - Unhide current file or tagged files.
  644.       Shift F5  - Protect current or tagged file(s). (Make Read Only)
  645.       Shift F6  - Unprotect current or tagged file(s).
  646.       Shift F7  - Sort current window by file size, ascending.
  647.       Shift F8  - Sort by creation time, most recent file first.
  648.       Shift F9  - Display current time and date
  649.       Shift F10 - Enter a file mask for directory display.  It will
  650.                   remain  in effect until changed and is displayed in
  651.                   the top left corner of the file window.
  652.  
  653.  
  654.                        CONTROL/ALTERNATE KEY COMBINATIONS
  655.  
  656.   Ctrl-B..... Will  initiate the EASYFILE BACKUP utility.  Any tagged files in
  657.               the "source" directory will be compared to files in the "target"
  658.               directory.  By default, the currently  selected  window  is  the
  659.               source  directory  and  the  other  window  contains  the target
  660.               directory. Files will be copied, only if they do  not  exist  on
  661.               the  target,  or  if the date/time stamp on the source files are
  662.               newer than those on the target files. Files  remain  tagged  for
  663.               optional deletion.
  664.  
  665.   Ctrl-D..... Pressing Control-D will load a secondary copy of COMMAND.COM and
  666.               return to the DOS prompt.  (The user  will  be  in  the  CURRENT
  667.               drive\directory).  When ready, type EXIT to return to EASYFILE.
  668.  
  669.   Ctrl-Enter. Performs the same function as the "XEQ" command.
  670.  
  671.  
  672.  
  673.   EASYFILE User's Manual                                                Page 14
  674.  
  675.  
  676.                 CONTROL/ALTERNATE KEY COMBINATIONS  (Continued)
  677.  
  678.   Ctrl-K..... Will convert an archive file of one format to  an  archive  file
  679.               with  the  alternate  format. ARC formatted files are changed to
  680.               ZIP format files. Likewise, ZIP style archives are converted  to
  681.               ARC formatted files. This function can be executed on current or
  682.               tagged files. The converted  file  will  maintain  the  original
  683.               archive file date and time.
  684.  
  685.   Ctrl-N..... Will cause DOS rename to be executed on current file. A new name
  686.               will  be  prompted  for.  In  addition  (if  using  DOS  3.x)  a
  687.               subdirectory may be renamed by making it the current file,  then
  688.               using this key.
  689.  
  690.   Alt-P...... Will  send  a  listing  of the current,  sorted directory to the
  691.               printer.
  692.  
  693.   Ctrl-Q..... Exit EASYFILE with the current directory active.
  694.  
  695.   Alt-R...... Will refresh the entire screen display of  EASYFILE.  This  will
  696.               straighten  out  a  screen that may have been messed up by stray
  697.               DOS hardware messages.
  698.  
  699.   Ctrl-R..... Will refresh the display of the current window.  This  is useful
  700.               if the execution of some file from within EASYFILE  has  changed
  701.               the  displayed  directory  by  adding  or  deleting a file.  The
  702.               refresh will display the new, changed directory.
  703.  
  704.   Alt-S...... Display files unsorted - as they are  actually  stored  on  your
  705.               disk.
  706.  
  707.   Ctrl-T..... Toggle screen between  CGA (25 line)  and  EGA/VGA  (43/50 line)
  708.               modes.
  709.  
  710.   Ctrl-X..... Performs the same function as the "XEQ" command.
  711.  
  712.  
  713.                        *** USING EASYFILE WITH A MOUSE ***
  714.  
  715.   EASYFILE will detect the presence of a mouse and display a cursor for it  on
  716.   the  screen.  This  mouse  cursor  may be moved and used to select on-screen
  717.   functions.  Selection is normally performed by positioning the mouse  cursor
  718.   then  clicking  with  a  mouse  button.  The  result  of the button press is
  719.   dependent on the current location of the mouse cursor.
  720.  
  721.   When discussing the mouse functionality,  the EASYFILE screen may be divided
  722.   into  seven regions (A through G).  The actions carried out by EASYFILE when
  723.   a mouse button is pressed depends on which region the mouse  cursor  is  in.
  724.   Figure  2  defines  the  regions of the EASYFILE display.  There is only one
  725.   region A and one region B. Both file windows have regions C through G.
  726.  
  727.  
  728.  
  729.   EASYFILE User's Manual                                                Page 15
  730.  
  731.  
  732.                       *** USING EASYFILE WITH A MOUSE ***
  733.                                   (Continued)
  734.  
  735. -------------------------------------------------------------------------------
  736.                                     Region A
  737. -------------------------------------------------------------------------------
  738.                                     Region B
  739. |--------------------------------------||-------------------------------------|
  740. | *.*          DISK1_VOL2        name  ||               Region C              |
  741. |                 D:\                  ||               Region D              |
  742. |--------------------------------------||-------------------------------------|
  743. | DPE            <DIR>                 ||                                     |
  744. | GAMES          <DIR>                 ||                                     |
  745. | GRAPHICS       <DIR>                 ||                                     |
  746. | INCLUDE        <DIR>                 ||                                     |
  747. | INCOMING       <DIR>                 ||
  748. | LASER          <DIR>                 ||                                     R
  749. | LIB            <DIR>                 ||                                     e
  750. | MOUSE          <DIR>                 ||                                     g
  751. | PASCAL         <DIR>                 ||               Region F              i
  752. | SCAN           <DIR>                 ||                                     o
  753. | SCREEN         <DIR>                 ||                                     n
  754. | SHEET          <DIR>                 ||
  755. | SYSLIB         <DIR>                 ||                                     E
  756. | TEXT           <DIR>                 ||
  757. | UTILS          <DIR>                 ||                                     |
  758. | WINDOWS        <DIR>                 ||                                     |
  759. | WP             <DIR>                 ||                                     |
  760. | XFER           <DIR>                 ||                                     |
  761. |--------------------------------------||-------------------------------------|
  762. | dir:    0K  tag:    0K  left:11428K  ||               Region G              |
  763. |--------------------------------------||-------------------------------------|
  764.                  Figure 2 - Regions of EASYFILE monitor screen.
  765.  
  766.  
  767.   Region A - This area of the screen is refered to as the  TOP  LINE  MENU.  It
  768.              consists  of  the first line of the display.  Top line menu  items
  769.              may  be performed by moving the mouse cursor to the desired option
  770.              and pressing the left mouse button.
  771.  
  772.   Region B - The  second  line of the screen is refered to as the MESSAGE LINE.
  773.              When selecting items on the top line  menu a  description  of  the
  774.              menu  item's function will appear here.  Messages may also  appear
  775.              on  this line when copying,  moving,  deleting or performing other
  776.              functions. The message line is also used to prompt for and  obtain
  777.              keyboard input from the user.
  778.  
  779.  
  780.  
  781.   EASYFILE User's Manual                                                Page 16
  782.  
  783.  
  784.                       *** USING EASYFILE WITH A MOUSE ***
  785.                                   (Continued)
  786.  
  787.   Region B - While EASYFILE is prompting the user for  information  the  mouse
  788.              may  be  used for some of the input.  In this case,  clicking the
  789.              mouse button will have effect only if the cursor is in region  B.
  790.              If EASYFILE is asking for a file or directory path,  pressing the
  791.              left mouse button will accept the value currently  on  the  line.
  792.              Hitting  the  right  mouse  button  will  have the same effect as
  793.              hitting the ESC key.  EASYFILE may also ask you to choose between
  794.              the "[Current] or [Tagged]" files or to  select  the  appropriate
  795.              disk drive.  Placing the mouse cursor on the highlighted word and
  796.              pressing  the  left  mouse  button  will  select that word as the
  797.              response.  This simulates the keyboard response of  pressing  the
  798.              first letter of the word.
  799.  
  800.   Region C - Clicking on On region C has no effect.
  801.  
  802.   Region D - Pressing  the  left mouse button while on this line of the window
  803.              will cause the selection bar to scroll upward.
  804.  
  805.   Region E - This region contains the mouse scroll bar  for  the  window.  The
  806.              region is one column wide and contains a bright marker to signify
  807.              the window's current position in the directory list.  Clicking on
  808.              the scroll bar above the  marker  produces  the  same  result  as
  809.              hitting  the  PgUp  key.  Clicking  on  the  scroll bar below the
  810.              marker produces the same result as  hitting  the  PgDn  key.  The
  811.              marker itself may be moved by pressing and holding the left mouse
  812.              button  while  the  mouse cursor is positioned on it.  Moving the
  813.              mouse under this condition will allow  the  marker  to  be  moved
  814.              also.  Repositioning  of  the marker in this manner will readjust
  815.              the window's position within the directory list.
  816.  
  817.   Region F - If a subdirectory or archive has been  selected  as  the  current
  818.              file, you may click the left mouse button on the left half of the
  819.              selected  line  to  display  the  contents of the subdirectory or
  820.              archive in the left file window.  Pressing the left mouse  button
  821.              while on the right half of the selected line will display in  the
  822.              right  file  window.  The  "R"  in  the word "<DIR>" is the first
  823.              character for selecting the right window.
  824.  
  825.              If the mouse cursor is on a non-archive file name ,  clicking the
  826.              left mouse button has  the  same  effect  as  issuing  the  "XEQ"
  827.              command.
  828.  
  829.              Clicking the right mouse button will TAG the file.
  830.  
  831.              While using the "Pick" or "Apps" options from the top line  menu,
  832.              pressing  the  left  mouse  button  will  execute the highlighted
  833.              selection and clicking  the  right  button  will  escape  without
  834.              choosing.
  835.  
  836.   Region G - Pressing the left mouse button while on  the  last  line  of  the
  837.              window will cause the selection bar to scroll downward.
  838.  
  839.  
  840.  
  841.   EASYFILE User's Manual                                                Page 17
  842.  
  843.  
  844.                          *** TOP LINE MENU COMMANDS ***
  845.  
  846.   Top Line Menu selections control the most commonly  used  EASYFILE  actions,
  847.   and  are  invoked  by either moving the highlight to the desired command via
  848.   the spacebar,  tab key or mouse and pressing [Enter] (or left mouse button),
  849.   or  by keying the first letter of the command name.  The spacebar or tab key
  850.   moves the highlight to the right and the tab key,  when shifted,  moves  the
  851.   highlight  to  the  left.  Using the initial letter is the fastest method if
  852.   you are using keyboard input.
  853.  
  854.   The commands are as follows:
  855.  
  856.   UnTagAll... Will turn off any file highlighting within current window.
  857.  
  858.   Copy....... Will cause DOS copy to be executed on current or  tagged  files.
  859.               New ZIP or ARC files are created by copying one or more files to
  860.               a file name having a ZIP or ARC extension.
  861.  
  862.   Move....... Will  move  (without  copying,   if  possible)  files  from  one
  863.               subdirectory to another.
  864.  
  865.               Files  will  be  MOVED  (rather than copied) across subdirectory
  866.               boundaries if the two directories are on the  same  disk  drive.
  867.               Otherwise,  EASYFILE will perform the function by first  copying
  868.               and then deleting the original file. Moves are only performed if
  869.               the  destination  directory  does not contain a file by the same
  870.               name.
  871.  
  872.               Moving  a  file  is  performed  faster than copying and does not
  873.               degrade hard disk performance through disk fragmentation  caused
  874.               by reorganization. With MOVE the files are not physically moved,
  875.               their disk location identifier is merely changed.
  876.  
  877.   Delete..... Will cause DOS delete to be executed on current or tagged files.
  878.  
  879.   TagAll..... Will  turn  on  file  highlighting  for all files within current
  880.               window,  so that all files will be subject to  action.  Selected
  881.               files may be untagged with either the F9 or F10 keys.
  882.  
  883.   Other...... Will replace the top line menu with a set  of  pull-down  menus.
  884.               These menus allows access to the remaining EASYFILE features not
  885.               available  directly  from the top line menu.  A particular pull-
  886.               down menu may be selected either with the mouse or by using  the
  887.               left  and  right  arrow keys.  An item within the pull-down menu
  888.               can be selected by using the up and down arrow keys or with  the
  889.               mouse.  To  perform  the  chosen selection,  either hit ENTER or
  890.               press the left mouse button.  Hitting the ESC key or  the  right
  891.               mouse  button  will  exit  from  the  pull-down  menu system and
  892.               restore the original top line menu.  Pressing any  mouse  button
  893.               when  the  mouse cursor is not inside a pull-down menu will also
  894.               exit.
  895.  
  896.               Remember,  each of the functions in the pull-down menus can also
  897.               be performed by using the associated key sequence listed on  the
  898.               menu.
  899.  
  900.   EASYFILE User's Manual                                                Page 18
  901.  
  902.  
  903.                          *** TOP LINE MENU COMMANDS ***
  904.                                   (Continued)
  905.  
  906.   Apps....... Will  display a user defined applications menu.  The contents of
  907.               one file window will be replaced by the menu.  You may  use  the
  908.               cursor  keys (or mouse) to choose a selection,  then the [Enter]
  909.               key (or left mouse button) to perform it,  or [ESC] to return to
  910.               the normal display. These are the only key presses which will be
  911.               acknowledged  during the display of the user defined menu.  This
  912.               menu allows the user to run applications without needing to know
  913.               their disk location nor the proper command line  arguments.  See
  914.               the  section  on  "Application Menus" for further information on
  915.               constructing application menu files.
  916.  
  917.   XEQ........ The currently selected file,  if an executable type,  i.e.  with
  918.               extension BAT,  COM,  or EXE, will be run.  EASYFILE will prompt
  919.               the user for command line parameters prior to execution.  If the
  920.               file's extension is one of those specified by the EXTCMD  option
  921.               in the command list file,  the file name will be substituted for
  922.               each caret (^) on the EXTCMD line.
  923.  
  924.               For example: If the command list file contains the line
  925.  
  926.                                     EXTCMD=EDIT ^.TXT /C
  927.  
  928.                            and the currently selected file is named
  929.  
  930.                                     SHOPLIST.TXT
  931.  
  932.                            then the following command would be sent to DOS
  933.  
  934.                                     EDIT SHOPLIST.TXT /C
  935.  
  936.               There are two additional key combinations (Ctrl-X &  Ctrl-Enter)
  937.               that  will  perform  the  same  function  as  the  "XEQ" option.
  938.               Pressing Ctrl-D may also be used  to  run  other  programs  from
  939.               within EASYFILE.  This is covered in the CONTROL KEY area of the
  940.               documentation.
  941.  
  942.   Pick....... Will show an alphabetically sorted,  visual directory tree.  You
  943.               will first be prompted to select  a  disk  drive.  Type  in  the
  944.               letter  of  the  drive  or  select  the letter with the mouse by
  945.               clicking the left mouse button while the mouse cursor is on  the
  946.               drive  letter.  You may then use the cursor keys or the mouse to
  947.               select a subdirectory,  then [Enter] to display it,  or [ESC] to
  948.               return to the normal display.
  949.  
  950.   List....... Will  invoke  EASYFILE's  internal browse feature or use another
  951.               program as specified by the LISTCMD option in the  COMMAND  LIST
  952.               file.  The currently selected file path, name and extension will
  953.               be  passed  to  the  external  LIST  program  as  a command line
  954.               argument.  The LIST program must be in a directory  specifed  by
  955.               the DOS PATH command.
  956.  
  957.  
  958.  
  959.   EASYFILE User's Manual                                                Page 19
  960.  
  961.  
  962.                          *** TOP LINE MENU COMMANDS ***
  963.                                   (Continued)
  964.  
  965.   Edit....... Will  invoke an editor called ED or another program specified by
  966.               the  EDITCMD  option  in  the  EASYFILE  command list file.  The
  967.               currently selected file path,  name and extension will be passed
  968.               to the EDIT program as a command line argument.
  969.  
  970.   Quit....... Exits program and returns to DOS.
  971.  
  972.   After a menu selection or a key command is made,  EASYFILE will check to see
  973.   if any files are tagged. (These are files highlighted in the file window) If
  974.   it finds tagged files,  it will ask whether the user wants to act  upon  the
  975.   tagged  files  or  the current file only.  The user will see a prompt on the
  976.   message line and a small two choice menu which indicates the  two  available
  977.   choices.  A  choice  is to be made by typing the first letter of the desired
  978.   option.  If no files are tagged and when necessary, the user is prompted for
  979.   appropriate path or name entry.  Then EASYFILE will ask for verification  of
  980.   the  pending action.  A "Y" response causes execution of the command,  while
  981.   pressing the "N" or ESC keys will abort the  operation  and  return  to  the
  982.   normal display with any tagged files still highlighted.
  983.  
  984.  
  985.                            *** APPLICATION MENUS ***
  986.  
  987.   EASYFILE allows you to build your own personalized  menus.  The  application
  988.   menu  which  is  loaded  upon  startup  of  EASYFILE can be specified in the
  989.   COMMAND LIST file.  The "apps=" command option may be used  to  specify  the
  990.   menu's  file  name.  Application  menus  consist  of text files which may be
  991.   produced with any editor that can create ASCII files.
  992.  
  993.   Take  a  moment  to  examine  the  contents  of  the  included   menu   file
  994.   APPSMENU.TXT.  Its  structure  is  actually  very  simple.  There are only 4
  995.   types of entries.  These types are:
  996.  
  997.               1) BLANK LINES. These are ignored by EASYFILE.
  998.  
  999.               2) THE  MENU  TITLE.  The  Main  menu  title  is the
  1000.                  heading displayed at the top  of  the  menu.  The
  1001.                  menu  title MUST start in the first column.  Only
  1002.                  the first 38 characters of the menu title will be
  1003.                  used.  The title will be centered  on  the  first
  1004.                  line of the menu.
  1005.  
  1006.               3) THE   APPLICATION  NAME.   The  application  name
  1007.                  consists of the text displayed  on  the  menu  to
  1008.                  describe  the selection.  The names MUST start in
  1009.                  the second column (column 2)  and  may  be  long,
  1010.                  although,  only  the first 38 characters are used
  1011.                  by  EASYFILE.   Please  note   that   the   first
  1012.                  character  of the line MUST be a space,  with the
  1013.                  first letter of the application name starting  in
  1014.                  column 2.
  1015.  
  1016.  
  1017.  
  1018.   EASYFILE User's Manual                                                Page 20
  1019.  
  1020.  
  1021.                             *** APPLICATION MENUS ***
  1022.                                    (Continued)
  1023.  
  1024.               3) The  ampersand  sign  (&)  has a special function
  1025.                  when it appears on the application name line.  It
  1026.                  is not displayed on the screen. It may be used as
  1027.                  a  place  holder  to  specify that the line is an
  1028.                  application name line by placing it in column  2.
  1029.                  This  allows  you  to  create an application name
  1030.                  that starts with one or more  blank  spaces.  The
  1031.                  line  could start with an ampersand,  followed by
  1032.                  several  spaces  and  then  the  text  you   wish
  1033.                  displayed on the menu as a description.
  1034.  
  1035.               4) THE MENU ACTION LINES. For each application name,
  1036.                  The first line specifies  the  initial  directory
  1037.                  (or  path),  and  subsequent  lines  can  specify
  1038.                  special EASYFILE commands or the application  you
  1039.                  wish  to  run  and  any  parameters  that  may be
  1040.                  required.  These lines MUST  BE  PRECEDED  BY  AT
  1041.                  LEAST TWO SPACES, or a TAB character.  (All these
  1042.                  spaces, or lack of them,  are used by EASYFILE to
  1043.                  tell the various kinds of lines apart.)
  1044.  
  1045.                  Initial  Directory Specification:  The first line
  1046.                  specifies  the  initial  directory,  and  may  be
  1047.                  preceded  by  a  disk  drive  identifier.  If you
  1048.                  desire to use the currently logged directory, use
  1049.                  a period "." for the directory specification.
  1050.  
  1051.                  PASSWORD command: Any menu action line beyond the
  1052.                  first  can  be used to specify a password for the
  1053.                  previously defined menu selection.  The line must
  1054.                  consist of at least two blank spaces followed  by
  1055.                  the  word PASSWORD,  a space and the chosen word.
  1056.                  Only the first 8 characters of the word are used.
  1057.  
  1058.                  RECONFIGURE command:  Any menu action line beyond
  1059.                  the first can be used to order EASYFILE to reload
  1060.                  the COMMAND LIST file. When the defined menu item
  1061.                  is  selected EASYFILE will configure itself based
  1062.                  on the contents of the  COMMAND  LIST  file.  The
  1063.                  line  must  consist  of at least two blank spaces
  1064.                  followed by the word RECONFIGURE.
  1065.  
  1066.                  READMENU command: Any menu action line beyond the
  1067.                  first can be  used  to  order  EASYFILE  to  load
  1068.                  another  application menu.  When the defined menu
  1069.                  item  is  selected   EASYFILE   will   load   the
  1070.                  application  menu.  To  specify  the  name of the
  1071.                  application menu file the line must consist of at
  1072.                  least two  blank  spaces  followed  by  the  word
  1073.                  READMENU,  a  space,  two  question marks and the
  1074.                  desired application menu's file name.
  1075.  
  1076.  
  1077.   EASYFILE User's Manual                                                Page 21
  1078.  
  1079.  
  1080.                             *** APPLICATION MENUS ***
  1081.                                    (Continued)
  1082.  
  1083.               4) Application Specification:  All other menu action
  1084.                  lines not described above are  considered  to  be
  1085.                  application specifications.  These lines are used
  1086.                  to  specify  the application,  and any associated
  1087.                  parameters.  Several  application  specifications
  1088.                  may  be  given  for a menu selection but only the
  1089.                  last one listed will  be  used  by  EASYFILE.  An
  1090.                  application  specification  consists  of at least
  1091.                  two blank spaces followed by a valid program name
  1092.                  and its string of command  line  parameters.  The
  1093.                  program name may include the full path name.
  1094.  
  1095.                  The  application  specification  can  also  cause
  1096.                  EASYFILE to prompt the user for input.  Prompting
  1097.                  occurs if the first character of the command line
  1098.                  parameter   string   is   a  question  mark  "?".
  1099.                  Everything following the question mark, up to the
  1100.                  next question mark, if any, is assumed to be part
  1101.                  of the prompt string.  If a second question  mark
  1102.                  is  found,  everything  after the second question
  1103.                  mark is used for the default answer.  The default
  1104.                  answer is displayed after the prompting text  and
  1105.                  may be edited by the user.
  1106.  
  1107.                  If there is  nothing  after  the  first  question
  1108.                  mark,  a  stock  phrase  is  used.  See below for
  1109.                  examples of all the possibilities and the results
  1110.                  they provide.
  1111.  
  1112.                  Parameter string : ?
  1113.                    Prompt         : Enter parameters for application:
  1114.                    Default        : <blank>
  1115.  
  1116.                  Parameter string : ??
  1117.                    Prompt         : Enter parameters for application:
  1118.                    Default        : <blank>
  1119.  
  1120.                  Parameter string : ?Please Enter info for this application
  1121.                    Prompt         : Please Enter info for this application
  1122.                    Default        : <blank>
  1123.  
  1124.                  Parameter string : ?Enter name of data file?JAN1988.DAT
  1125.                    Prompt         : Enter name of data file
  1126.                    Default        : JAN1988.DAT
  1127.  
  1128.                  Parameter string : ??margin:10 pitch:12
  1129.                    Prompt         : Enter parameters for application:
  1130.                    Default        : margin:10 pitch:12
  1131.  
  1132.  
  1133.  
  1134.   EASYFILE User's Manual                                                Page 22
  1135.  
  1136.  
  1137.                             *** APPLICATION MENUS ***
  1138.                                    (Continued)
  1139.  
  1140.               4) The application  command  line  and  the  default
  1141.                  string  can make use of a special function called
  1142.                  the file name inserter.  This function is invoked
  1143.                  through the use of the at-sign ( @ )  symbol  and
  1144.                  is described in greater detail later.
  1145.  
  1146.                  EASYFILE's  file  name inserter becomes activated
  1147.                  if  the   default   application   specification's
  1148.                  command   or   default  strings  contains  any  @
  1149.                  symbols.  There  are  several  special  character
  1150.                  combinations  that EASYFILE uses to insert files.
  1151.                  Along with  the  following  possibilities  listed
  1152.                  below,    is    the    result    if    the   file
  1153.                  C:\DICT\WORDS.TXT is  the  currently  highlighted
  1154.                  file:
  1155.  
  1156.                       @         Not changed
  1157.                                 Result = @
  1158.  
  1159.                       @:        Provides current disk name
  1160.                                 Result = C:
  1161.  
  1162.                       @:\       Provides disk and path
  1163.                                 Result = C:\DICT\
  1164.  
  1165.                       @:\^      Provides disk, path and filename root
  1166.                                 Result = C:\DICT\WORDS
  1167.  
  1168.                       @:\^.^    Provides disk, path and full filename
  1169.                                 Result = C:\DICT\WORDS.TXT
  1170.  
  1171.                       @\        Provides path
  1172.                                 Result = \DICT\
  1173.  
  1174.                       @\^       Provides path and filename root
  1175.                                 Result = \DICT\WORDS
  1176.  
  1177.                       @\^.^     Provides path and full filename
  1178.                                 Result = \DICT\WORDS.TXT
  1179.  
  1180.                       @^        Provides filename root
  1181.                                 Result = WORDS
  1182.  
  1183.                       @^.^      Provides full filename
  1184.                                 Result = WORDS.TXT
  1185.  
  1186.  
  1187.  
  1188.   EASYFILE User's Manual                                                Page 23
  1189.  
  1190.  
  1191.                             *** APPLICATION MENUS ***
  1192.                                    (Continued)
  1193.  
  1194.                                   Sample Menu 1
  1195.  
  1196.   The following is a sample menu which demonstrates some basic specifications.
  1197.  
  1198.   Sample Menu 1
  1199.    List file
  1200.           .
  1201.           List
  1202.    Spell Checker
  1203.           c:\spell
  1204.           cspell
  1205.    Spreadsheet
  1206.           c:\sheet
  1207.           123
  1208.  
  1209.   The main menu heading  for  the  above  sample  is  "Top  Menu".  The  first
  1210.   selection  listed on the above menu would be "List File".  When this item is
  1211.   selected EASYFILE would go to work.  Since the  subdirectory  line  consists
  1212.   solely  of  a  period,   no  change  of  subdirectories  would  occur.   The
  1213.   application line has the application name LIST, with no parameters. EASYFILE
  1214.   will issue the commands to load and execute the LIST program.
  1215.  
  1216.  
  1217.                                   Sample Menu 2
  1218.  
  1219.   Let  us  now examine a more complex menu structure.  In this next example we
  1220.   will discuss the  more  advanced  menu  capabilities.  Assume  the  filename
  1221.   README.1ST is currently highlighted in the directory display.
  1222.  
  1223.   Sample Menu 2
  1224.    Customize EASYFILE
  1225.           c:\syslib
  1226.           ezinst
  1227.    Reload EASYFILE configuration
  1228.           .
  1229.           reconfigure
  1230.    Word Processing
  1231.           c:\text
  1232.           edit ?Enter file to edit:?@^.^
  1233.    Games Menu
  1234.           .
  1235.           readmenu ??c:\syslib\gamemenu.txt
  1236.           password icanplay
  1237.    Check current disk for errors
  1238.           .
  1239.           chkdsk ?Enter disk to check:?@:
  1240.    Edit TXT file associated with highlighted file
  1241.          .
  1242.          ed @^.TXT
  1243.  
  1244.  
  1245.  
  1246.   EASYFILE User's Manual                                                Page 24
  1247.  
  1248.  
  1249.                             *** APPLICATION MENUS ***
  1250.                                    (Continued)
  1251.  
  1252.                                   Sample Menu 2
  1253.  
  1254.   The first of the preceding popup menu options shows a simple way to add in a
  1255.   command  to allow customization of EASYFILE.  The initial directory is first
  1256.   set to C:\SYSLIB,  the assumed location of the EZINST.EXE program  for  this
  1257.   example, and then EZINST.EXE is run.
  1258.  
  1259.   The second popup menu option illustrates the use of the RECONFIGURE command.
  1260.  
  1261.   The third option shows an example of  how  the  user  may  be  prompted  for
  1262.   information prior to running the application. In this case, the user will be
  1263.   prompted  with the words "Enter file to edit:" on the screen's MESSAGE LINE.
  1264.   The file name inserter has also been invoked by using the @  sign.  In  this
  1265.   case,  the  file  name  inserter  will  place  the  the  current  file  name
  1266.   (README.1ST) into the default response string.  The default response may  be
  1267.   altered,  if  necessary,  by  the user.  It will be used as the command line
  1268.   argument when calling the application program.
  1269.  
  1270.   The fourth popup menu option demonstrates the proper  use  of  the  READMENU
  1271.   command.  If the "Games Menu" selection is chosen from the above application
  1272.   menu,   EASYFILE   will   load   a   new   application   menu   file   named
  1273.   C:\SYSLIB\GAMEMENU.TXT.  In this case however, the PASSWORD command has also
  1274.   been  used.  This will require the user to enter the designated word (listed
  1275.   here as "icanplay") or else the menu action will not be performed.
  1276.  
  1277.   The fifth option will provide the current disk as the default response.
  1278.  
  1279.   The  last  menu option will issue the command ED README.TXT to the operating
  1280.   system.
  1281.  
  1282.   Application names that have no menu action lines associated with them will
  1283.   not produce any action by EASYFILE when selected.
  1284.  
  1285.  
  1286.  
  1287.   EASYFILE User's Manual                                                Page 25
  1288.  
  1289.  
  1290.               *** EZINST -- The EASYFILE Configuration Utility ***
  1291.  
  1292.   EZINST is provided to help you generate the necessary EASYFILE command  list
  1293.   file for the options you want to use.  EZINST.EXE is invoked by entering
  1294.  
  1295.                            EZINST [command list file name]
  1296.  
  1297.   at  the  DOS  prompt.  The  square  brackets  are used to denote an optional
  1298.   argument, and are not typed.  If the command list file name is not specified
  1299.   on the command line,  the program will look for the  default  file  name  of
  1300.   COMLIST.TXT.  Simply run EZINST and follow the on screen instructions.  Help
  1301.   is available by pressing the F1 key.
  1302.  
  1303.  
  1304.             *** EZMENU -- The EASYFILE application menu generator ***
  1305.  
  1306.   EZMENU is provided to help you produce application  menu  files.  EZINST.EXE
  1307.   is invoked by entering
  1308.  
  1309.                            EZMENU [application menu file name]
  1310.  
  1311.   at the DOS prompt.  The square brackets  are  used  to  denote  an  optional
  1312.   argument,  and  are  not  typed.  If  there is no file name specified on the
  1313.   command  line,   the  program  will  look  for  the  default  file  name  of
  1314.   APPSMENU.TXT.  Simply run EZMENU and follow the on screen instructions. Help
  1315.   is available by pressing the F1 key.
  1316.  
  1317.  
  1318.                               *** MISCELLANEOUS ***
  1319.  
  1320.   EASYFILE   has   many  user  safeguards  built  in,   with  as  many  escape
  1321.   opportunities as is prudent,  but not intending to slow down the user.  This
  1322.   program,  used  carefully,  will  be  of  immense value.  If used carelessly
  1323.   however,  it can be dangerous.  Please be careful.  READ  the  messages  and
  1324.   prompts as they are presented.
  1325.  
  1326.   If you wish additional features to be included in EASYFILE or  you  discover
  1327.   any  program  errors (write down any error messages displayed on the screen)
  1328.   please contact:
  1329.  
  1330.                                 Dennis R. LaBelle
  1331.  
  1332.                               Compuserve 71350,3312
  1333.                               Genie       D.LABELLE
  1334.  
  1335.  
  1336.   ARC is a trademark of Software Enhancement Associates
  1337.  
  1338.